package com.ms.service.inter;

import com.ms.entity.User;
import java.util.List;

/**
 * 用户服务接口 - 定义用户相关的业务逻辑
 */
public interface UserService {

    /**
     * 保存用户信息
     * @param user 用户对象
     * @return 保存结果
     */
    boolean save(User user);

    /**
     * 根据用户ID查找用户
     * @param userID 用户ID
     * @return 用户对象
     */
    User findById(Integer userID);

    /**
     * 根据用户名查找用户
     * @param username 用户名
     * @return 用户对象
     */
    User findByUsername(String username);

    /**
     * 根据邮箱查找用户
     * @param email 邮箱
     * @return 用户对象
     */
    User findByEmail(String email);

    /**
     * 根据手机号查找用户
     * @param phone 手机号
     * @return 用户对象
     */
    User findByPhone(String phone);

    /**
     * 根据用户名、邮箱或手机号查找用户
     * @param account 用户名、邮箱或手机号
     * @return 用户对象
     */
    User findByAccount(String account);

    /**
     * 更新用户信息
     * @param user 用户对象
     * @return 更新结果
     */
    boolean update(User user);

    /**
     * 删除用户
     * @param userID 用户ID
     * @return 删除结果
     */
    boolean delete(Integer userID);

    /**
     * 获取所有用户
     * @return 用户列表
     */
    List<User> findAll();
    
    /**
     * 查找指定年份前缀的最大numID
     * @param prefix 年份前缀，如"2023"
     * @return 最大的numID，如果没有找到则返回null
     */
    String findMaxNumIdForYear(String prefix);
}
